home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 1.iso / util / prqwk21b.zip / PROQWK.TXT < prev    next >
Text File  |  1994-09-14  |  31KB  |  618 lines
  1. ProQWK.txt
  2. ----------
  3.  
  4. (See end of this file for revision history.)
  5.  
  6. LEGAL STUFF:
  7. ------------
  8.  
  9. This is the text file that accompanies ProQWK, (c) 1994 by
  10. Carl Mellesmoen.
  11.  
  12. "ProComm Plus for Windows", "Windows ASPECT" and "Action Bar" are
  13. trademarks (c) 1992-1994 Datastorm Technologies, Inc.
  14.  
  15. "Windows" is a trademark of Microsoft Corporation.
  16.  
  17. The script "PQ21.WAX" was compiled using the Windows ASPECT compiler,
  18. but was NOT written by Datastorm Technologies or any of its employees.
  19.  
  20. The author is not affiliated with Datastorm Technologies in any
  21. way.
  22.  
  23. DISCLAIMER:
  24. -----------
  25.  
  26. The author does not make any guarantees, implicit or explicit,
  27. regarding the script "PQ21.wax", and is not responsible for anything
  28. that may occur as a result of using it.  Users of this script are
  29. expected to exercise discretion and accept responsibility for such
  30. use, and any effects arising thereof.  So there.
  31.  
  32. ABOUT ProQWK:
  33. -------------
  34.  
  35. What does this script do?
  36. -------------------------
  37.  
  38.     ProQWK is a little utility meant for ProComm Plus for Windows users.
  39. We think it satisfies a need that many PC+/Win users have -- that is, to
  40. rename QWK packets in such a manner that the user can keep many QWK packets
  41. from the same source in their download directory at one time.  The utility
  42. renames QWK packets so that when a download of a new QWK packet takes
  43. place, the file transfer doesn't crash.  As well, ProQWK checks for the
  44. existence of a file with the extension "QWK", and if it doesn't find it,
  45. it won't rename.  Thus, users don't have to try and remember whether they
  46. renamed their QWK files previously.
  47.     When a user chooses to rename a series of QWK files, ProQWK will
  48. delete the highest-numbered file that it is configured to keep for the BBS
  49. in question.  For example, a user may have ProQWK configured to keep seven
  50. extra QWK packets for a BBS called, oh, let's say "redeye" for example.
  51. If the QWK file name for the BBS is "redeye", ProQWK will look for a file
  52. named "redeye.qw6" (because the user chose seven extra packets for that
  53. series, and ProQWK starts numbering QWK files at zero, eg., "redeye.qwO"),
  54. and upon finding it, will delete it.  Next, it will change the name of the
  55. file "redeye.qw5" (if found) to "redeye.qw6"; "redeye.qw4" to "redeye.qw5";
  56. "redeye.qw3" to "redeye.qw4", and so on, until it does the last renaming,
  57. "redeye.qwk" to "redeye.qw0".  If there was no "redeye.qwk" in the down-
  58. load subdirectory, ProQWK will not go through this renaming procedure,
  59. because it would be unnecessary.  Please note that each time ProQWK renames
  60. & cycles "QWK" files (actually "QW?" files) in this manner, one file will
  61. be deleted and each remaining "QW?" file will be bumped up one rung on
  62. the "ladder".
  63.     ProQWK also is designed to help out with another problem sometimes
  64. encountered when using QWK offline readers -- when uploading a reply packet,
  65. a user will sometimes forget whether they have already uploaded it --
  66. ProQWK alleviates this problem by allowing users to upload, and then
  67. delete the "REP" packet in one "motion".  They can also choose to  upload
  68. only, or to delete only, REP packets that they wish to upload or delete.
  69.  
  70. Why bother?
  71. -----------
  72.  
  73.     The main reason to use these utilities is to protect your QWK
  74. packets from premature deletion.  Some users may only keep one copy of a
  75. QWK packet for a particular BBS, read it, delete it, and then download
  76. a new one.  ProQWK is not going to be of much use to them.  But if you
  77. want to keep a packet from yesterday, and from a couple of days before
  78. that (etc.), for example, you may find ProQWK useful.  You can always go
  79. a packet or two (or up to thirty-five) back & find those messages that you
  80. read a few days ago.  If you don't keep multiple copies of QWK packets,
  81. once you delete that QWK packet, it's gone, unless you have some kind of
  82. deleted file recovery utility.  I like to think that ProQWK is a more
  83. elegant alternative.
  84.  
  85. But doesn't Zmodem automatically rename files?
  86. ----------------------------------------------
  87.  
  88.     In many communications software programs, zmodem downloads are
  89. automatically renamed when a file with the same name is already present in
  90. the download subdirectory.  The standard zmodem protocol, used by ProComm
  91. Plus for Windows, version 1.0, did not perform that function.  ProQWK 1.x was
  92. meant to at least enable users to work around this, if they desired to keep
  93. multiple copies of QWK files on their disk.  Due to popular demand, ProQWK 2
  94. has been developed for users of Procomm Plus/Windows 2, since 1.x versions
  95. will not run under this version of Procomm Plus/Win (with the exception of
  96. ProQWK 1.3, which was written in Visual Basic ((c) Microsoft Corporation)).
  97. While PCP/Win 2.0 will rename Zmodem downloads, a lot of users have gotten
  98. used to using ProQWK, and version 2.0 ensures that they can continue to use
  99. it.
  100.  
  101. How do I use it?
  102. ----------------
  103.  
  104.     Before downloading a fresh "qwk" packet for a BBS, simply choose
  105. the "QWK" option from the main menu and select the name of the BBS whose
  106. "qwk" packet you are about to download (ProQWK must be first set up to rename
  107. the files for that BBS.  See section below regarding setup.).  ProQWK will
  108. then rename the "QW?" files associated with that BBS, provided the setup
  109. was run properly.  As well, you can delete individual QW? files using
  110. ProQWK, rather than switching to a file management utility.  You can
  111. rename files at any time -- you do not need to be about to download a
  112. new "QWK" file.  You can select multiple BBSes for which you want to
  113. rename QW? files, using the Windows standard "CTRL-click" to add subsequent
  114. selections, or "CTRL-shift" to add all items between a previously selected
  115. BBS and the current selection.
  116.  
  117. Also, as a new feature in version 2.0, you may run ProQWK as a "command-line"
  118. program -- if you use a script that sets the predefined WASP variable, S0 to
  119. the string value "allqwk" (case insensitive), and then launches PQ21.WAX.
  120. Such a script is included in this archive, both in source code ("Allqwk.was")
  121. and in wax form ("Allqwk.wax").  When ProQWK 2.0 is invoked in this manner,
  122. it will automatically run through the renaming routine for ALL BBSes named
  123. in the ProQWK.INI file that are properly configured, without the need for
  124. any intervention from the user (NOTE:  Unregistered users will have to click
  125. a button on a "nag screen" that appears after ProQWK runs -- so if you have
  126. not registered, don't use ProQWK in this way, unless you can afford to have
  127. it keep running until such a time as you can make the final click.).
  128. You should not need to alter the source code at all in order to use this script,
  129. but it has been provided for those who want to incorporate it into larger scripts
  130. (such as late-night mail runs) since it will run ProQWK in the above manner and
  131. return to the launching script (ALLQWK), which does not perform any further
  132. instructions.  If you wish to have a script launch PROQWK in the above manner
  133. and NOT return to the launching script, use the "chain" command rather than
  134. the "execute" command.
  135.  
  136. DO NOT ATTEMPT TO RENAME "QWK" PACKETS DURING A DOWNLOAD, OR WHEN A DOWNLOAD
  137. IS IMMINENT!  THIS MAY/WILL RUIN YOUR DOWNLOAD! (You may rename "QWK" files
  138. for BBS "A" while downloading a "QWK" file for BBS "B", but not for "A" while
  139. downloading "A")
  140.  
  141.     We suggest assigning a Meta Key or Action Bar Icon to the "PQ21.wax"
  142. script, in order to have ProQWK available at the touch of a button.  See your ProComm
  143. Plus for Windows user manual, or online help for more information on setting up
  144. Meta Keys or Action Bar icons to run scripts.
  145.  
  146. FILES NEEDED:
  147. -------------
  148.  
  149. In order to use ProQWK Utilities, you need to have the archive,
  150. "PRQWK21B.ZIP", which includes:
  151.  
  152.     ProQWK.txt    this file
  153.     PQ21.wax    the Windows ASPECT executable file
  154.     Allqwk.wax     launches "command line" ProQWK session
  155.     Allqwk.was    source code for allqwk.wax
  156.     socsof2.nil    the icon library for ProQWK 2.0
  157.  
  158. Installation & Setup:
  159. ---------------------
  160.  
  161.     Uncompress the file "PRQWK21B.ZIP" using PKZIP or other program
  162. that can uncompress "ZIP" files.
  163.  
  164.     The only files that need to be in any specific subdirectory are
  165. "PQ21.wax", which should be copied to the subdirectory in which ProComm
  166. Plus for Windows 2 expects to find your Windows ASPECT scripts; and
  167. "socsof2.nil", which should be copied to the subdirectory in which the
  168. executable "PW2.EXE" (for ProComm Plus for Windows 2) is located (for
  169. example "c:\prowin2").  If you wish to use the "command line" option, you will
  170. need to copy "Allqwk.wax" to your ASPECT subdirectory, and if you wish to make
  171. changes to "allqwk.wax", or to incorporate its source code into other scripts,
  172. you will need to copy "allqwk.was" to your PCP/W 2 ASPECT subdirectory.
  173.  
  174.     Once the files have been placed in the proper subdirectories,
  175. the script can be run by selecting "Scripts...Run..." from the ProComm
  176. Plus for Windows pull-down menus, and choosing "PQ21.wax" from the list
  177. that appears, or by launching from an Action Bar icon or a Metakey (see your
  178. Procomm Plus/Win 2 User Manual for details).  If you have not used ProQWK before
  179. (or if you have and your "ProQWK.ini" file has been moved, erased, or renamed),
  180. it will ask you if you wish to go through the setup routine.  If you wish to do so,
  181. select "Setup", and you will be taken directly to the setup routine.  If you
  182. choose "Cancel," the script will stop running and you will either have to
  183. find your "ProQWK.ini" file (if you have a copy in another location)
  184. and place it in your Windows subdirectory, or run ProQWK again and choose to
  185. go through the setup routine.
  186.  
  187.     ProQWK  will create a new file on your hard drive called
  188. "ProQWK.ini" (I know what you're thinking: "Ugh! Not ANOTHER 'ini' file!"
  189. But, it's not that bad! :) See "De-installing ProQWK" below.), which will
  190. be placed in your Windows subdirectory (if it is not already there).
  191. This file is necessary for ProQWK to read various setup information in order
  192. to be able to execute.  Whenever you save changes to your configuration, ProQWK
  193. will update the "ProQWK.ini" file.
  194.  
  195. Setup Options:
  196. --------------
  197.  
  198. When you are faced with the ProQWK setup dialog box, you will need
  199. to enter the path to your "download" subdirectory, which is where you
  200. keep your downloaded QWK files, for example "c:\prowin2\dnload". If you
  201. don't enter the proper path, ProQWK will not be able to rename/delete
  202. any of your QWK type files, and will be at least 50% useless.  The same
  203. follows for your "upload" subdirectory (eg. "c:\prowin2\upload") - if it
  204. is incorrectly entered, ProQWK will be at least 50% useless, and if both
  205. are mispelled, ProQWK will be at least 100% useless (grin)!  Please ensure
  206. that both directory paths have the proper drive name, eg. C:, D:, etc.,
  207. followed by a backslash ("\"), followed by the remainder of the path
  208. name, but without the final backslash (examples in description above).
  209. If you should happen to include a terminating backslash in your upload
  210. or download path, ProQWK will inform you that you shouldn't have done
  211. that and will remove the final backslash from your path name(s).
  212.  
  213. You will notice a check box underneath the path names, marked "Express
  214. Option".  This will be explained further under "Using ProQWK" below.
  215.  
  216. Underneath the "Express Option" checkbox is another checkbox labelled
  217. "Delete warning".  This option, when enabled, will ask you to confirm
  218. file deletions before performing them.  If the checkbox is not enabled,
  219. ProQWK will delete files without asking for confirmation.
  220.  
  221. On the right will be a message saying "BBS List".  There may or may not any
  222. BBS's in the corresponding list, depending on whether or not you have
  223. previously set up ProQWK to work with any particular BBS's.  If you have
  224. not, the area below the caption will be blank.
  225.  
  226. To add a bulletin board name for use by ProQWK, select the "Add BBS"
  227. button.  This will lead you to a new dialog box called "BBS Options". You
  228. will be prompted to enter the name of the QWK file for the BBS in question.
  229. Please be sure to enter the EXACT name of the QWK files for that BBS -- that
  230. is, whatever that BBS calls its own QWK files.  This name should not include
  231. any paths, nor should it include the extension ".qwk", since this will be
  232. taken care of by ProQWK when it runs.  If the file name is not correctly
  233. entered, ProQWK will not be able to rename the "QWK" packets in question.
  234. This dialog will also ask you for the number of EXTRA "QWK" packets you
  235. wish to keep on hand for the BBS in question.  Note that this means that
  236. if you enter "1", you will have as many as 2, and as few as 1 (or zero,
  237. if you manually delete them) QWK files for that BBS in your download
  238. subdirectory at any one time.  Similarly, if you enter 2, you will have
  239. up to 3 files, and if you enter 3, you will have up to 4 files, and so on.
  240. You may choose to keep as many as 36 "QWK" files for a BBS BY CHOOSING "35"
  241. for this entry.  When you are finished, select "Done", and ProQWK will
  242. cycle to the next BBS for which you need to enter information, or it will
  243. return you to the "ProQWK Setup" dialog when you have configured the last
  244. BBS that you wish to modify.  If you change your mind and do not want to
  245. configure ProQWK for this BBS, select "Delete", and ProQWK will not add it
  246. to its setup.
  247.  
  248. You may also edit or delete BBS's that were previously designated for
  249. ProQWK by selecting them in the "BBS List" and choosing "Edit/Delete".
  250. This basically works the same as adding a BBS (see above), except that
  251. the settings for the BBS will show up in the "BBS Options" dialog.  To
  252. save your changes, select "save" (and "Save-Exit" within the Setup
  253. dialog).  To remove a BBS from ProQWK's list, select the "Delete"
  254. button (note that some INI lines will remain in your ProQWK.INI file
  255. if you choose this option, but should not noticeably hinder ProQWK
  256. performance, unless there are hundreds of "unwanted" entries).
  257. To enforce changes and deletions, you will need to select "Save-Exit"
  258. (see below).
  259.  
  260. Once you are satisfied with the setup information you have entered,
  261. choose "Save-Exit" in the "ProQWK Setup" dialog. ProQWK will then save
  262. your settings/changes and you will be returned to the ProQWK main menu
  263. (or taken there for the first time, if you have not used ProQWK before).
  264.  
  265. If you do not want to save any changes you have made, or if you do not
  266. want to make any changes, select "Exit" in the Setup menu, and you
  267. will be taken to the main menu.
  268.  
  269. From the Setup menu, you may also choose to enter your registration name
  270. and number, allowing you to run ProQWK without the delay and "nag screen"
  271. displayed upon exiting ProQWK.
  272.  
  273. De-installing ProQWK (with apologies to grammarians)
  274. ----------------------------------------------------
  275.  
  276. To remove ProQWK, you need only erase the files:
  277.     "PQ21.wax"    in your PCP/Windows 2 ASPECT subdirectory;
  278.     "allqwk.wax"    and
  279.     "allqwk.was"     in your PCP/Windows 2 ASPECT subdirectory (if present);
  280.     "ProQWK.ini"    in your Windows subdirectory;
  281.     "ProQWK.txt"     (this file) wherever you put it;
  282. and    "socsof2.nil"    in your ProComm Plus for Windows subdirectory.
  283.     That's it!  No changes to your Autoexec.bat, config.sys, Win.ini
  284.         or System.ini files whatsoever!  Now, doesn't that sound
  285.         simple? (rhetorical question!)
  286.  
  287. RUNNING ProQWK:
  288. ---------------
  289.  
  290. From the main menu (entitled "ProQWK Utilities"), you may choose from 5
  291. different options:
  292.  
  293.     QWK files...
  294.     REP files...
  295.     Setup...
  296.     Quit
  297.     About ProQWK Utilities
  298.  
  299. QWK files:
  300. ----------
  301.  
  302. Choosing this option and selecting one or more BBS names (holding down the
  303. "CTRL" key while selecting a BBS will add it to the selections, while
  304. holding down the "Shift" key will select a BBS along with all names
  305. between it and a previous selection) enables the user of ProQWK to
  306. rename their QWK packets in such a way that the oldest file(s) will be
  307. deleted, and all newer ones will be renamed in such a manner that the
  308. extension of each "QWK" file will be changed to ".qw0", ".qw1", ".qw2",
  309. ".qw3", and so on, the highest number depending on the number of QWK
  310. packets to be kept as determined during the BBS setup procedure (see
  311. "installation" above).  The lower the number in a file extension for
  312. files renamed by this utility, the newer the file.  The newest file will
  313. have an extension of ".qw0", unless the file(s) for the BBS in question
  314. have not been renamed since the last QWK packet was downloaded, in which
  315. case the newest file will bear the extention ".QWK".  When the "Ok"
  316. button is selected in the "Rename QWK packets..." dialog, the script will
  317. execute the renaming for the BBS(s) in question if and only if there is a
  318. mail packet for the BBS with the extension ".qwk" present in the download
  319. subdirectory.  Otherwise, it will not perform the rename for that BBS.
  320. When multiple BBS's are chosen, the script will check for the ".qwk"
  321. extension for each BBS separately.  In this way, you do not have to worry
  322. about whether or not you are deleting a file each time whether it is
  323. necessary or not, since if it is not necessary (i.e. there is no ".qwk"
  324. file), nothing will be renamed (or deleted) for that BBS.  Once the QWK
  325. files are renamed, you will be either returned to the main menu (if
  326. "Express" is not checked), or the script will turn itself off (if "Express"
  327. is checked).  See the information regarding the "Express" option further on.
  328.     If you select "Cancel", ProQWK will return to the
  329. main menu without performing any renaming or deleting.
  330.     If you select "Delete files...", you will be presented with a new
  331. dialog box asking you to select a QWK file to delete.  The default download
  332. directory's "QW?" files will be listed.  You may select one or more files to
  333. delete (holding down the "CTRL" key while selecting a file will add it to
  334. the selections, while holding down the "Shift" key will select a file along
  335. with all files between it and a previous selection).  If you press "Cancel"
  336. you will be returned to the main menu (if the "Express" option is disabled),
  337. or ProQWK will exit (if "Express" is enabled).  If a file(s) is/are
  338. selected, "delete warning" is enabled, and the "Delete" key is pressed,
  339. you will be asked to confirm each deletion, and given one last chance to
  340. change your mind (if "Delete warning" is disabled, the files will be deleted
  341. without your being prompted to confirm the deletions).
  342.  
  343. NOTE: The default under the "QWK files" menu is "OK", which means that
  344. if you make a selection and press [ENTER], ProQWK will behave as if you
  345. clicked on "OK" with your mouse.
  346.  
  347. REP files:
  348. ----------
  349.  
  350.     Choosing "REP files..." from the main menu will lead you
  351. to the dialog box, "REP Management", which will allow you to do one of
  352. three things with your "REP" files:
  353.  
  354.     1) Upload
  355.     2) Upload & delete
  356.     3) Delete
  357.  
  358. In order to do any of these three things, you must first select a REP
  359. file from the list box on the left, and select the "Ok" button, or simply
  360. double-click on the REP file you want to process.
  361.  
  362. If no REP files appear in the "REP files..." menu, you have either not
  363. entered the proper "upload" subdirectory in ProQWK setup, or have changed
  364. the subdirectory in the list box, or you currently have no "REP" files
  365. in that subdirectory.
  366.  
  367. Note that an icon will be displayed which represents which of the three
  368. options are selected -- an "up arrow" & envelope for "upload", an
  369. "up arrow"/envelope with a small "bomb" superimposed for "upload & delete,"
  370. and a somewhat larger "bomb" for "delete."  As the selection is changed,
  371. so is the icon.  If you do not see the icon(s), you probably have not put
  372. the icon file, "socsof2.nil" in the proper subdirectory.  If you don't want to use
  373. the icons, you will have to either move the icon file to a different directory or
  374. rename or delete it, but note that in the process you will lose ALL of the icons
  375. that ProQWK uses.
  376.  
  377. The options that perform a file upload (the first two) are meant to be
  378. used only while you are online to a bulletin board.  You may change the
  379. transfer protocol before sending the file.  The default transfer protocol
  380. will be the one designated in your dialing directory for the BBS you are
  381. connected with.  You may change the transfer protocol to any protocol recognized
  382. by ProComm Plus for Windows by selecting the "Change protocol" combobox, which will
  383. present a drop-down list of available protocols (note that this will not change the
  384. default protocol for the BBS in your dialing directory -- it only enables the selected
  385. file to be sent via the selected protocol).  To select a new protocol, simply point
  386. and click.
  387.  
  388. The plain "upload" option simply sends the file to the remote host
  389. BBS, and warns you if the upload fails.  The "upload & delete" option will
  390. do the same as the "upload" option,and then ask you whether you wish to
  391. delete the file, if "delete warn" is enabled.  It will NOT ask to delete the
  392. file if the upload is not successful.  It's a good idea to wait for the bulletin
  393. board you are online to to inform you of whether your REP packet messsages have
  394. been sent to the proper message areas successfully BEFORE you confirm that you
  395. want to delete the REP packet (provided, of course, that "Delete warn" is enabled).
  396. Once you have been satisfied that your messages are on their way, you can
  397. then erase them with relative peace of mind.  We recommend using the
  398. "upload & delete" option to make it easier to keep track of which REP packets
  399. you have already uploaded - you can upload & delete all at once so you don't
  400. have to ask yourself a day or two later, "Now, did I send that mail packet yet
  401. or not?"  Of course, if you select the "upload" only option, you will still
  402. have to somehow remember when you uploaded your packets (darn!).
  403.  
  404. The third option, "Delete", when selected will delete the selected REP
  405. packet.  If you enabled "Delete warning" under the setup, you will be
  406. prompted before ProQWK deletes the file.
  407.  
  408. ProQWK will default to the option of the three above that was selected the
  409. last time you used the "REP Management" option.  For instance, if you
  410. select a REP file, and choose "Upload & delete", the next time you use
  411. ProQWK, "Upload & delete" will be the default selection.
  412.  
  413. If you delete a REP packet by mistake, you can probably still recover it,
  414. if you have some kind of deleted file recovery utility on your computer.
  415. If you choose "Ok" without highlighting a REP packet, ProQWK will
  416. tell you so.
  417.  
  418. After the actions described above have taken place, the script will return
  419. to the main menu, if the "Express" option is not selected, or shut itself
  420. off, if the "Express" option has been selected (see the section about the
  421. "Express" option further along).
  422.  
  423. NOTE:  The default for the "REP Management" window is "OK", which means
  424. that if you double-click on a REP filename, ProQWK will automatically
  425. perform the action by the designated radiobutton on the right (using
  426. the specified transfer protocol, if either of the first two radiobuttons
  427. are chosen).
  428.  
  429. Setup:    Described above.
  430. ------
  431.  
  432. Quit:    Exits script (who would've guessed?)
  433. -----
  434.  
  435. About ProQWK Utilities:
  436. -----------------------
  437.  
  438.     Choosing this button will invoke a dialog containing some
  439. information about ProQWK and how to register (see Registering ProQWK below)!
  440.  
  441. "Express" Option:
  442. _________________
  443.  
  444.     We figured that this script should run as unobtrusively as
  445. possible, so we included a feature called "Express".  When the "Express"
  446. checkbox is selected, the script will quickly (QWKly?) exit after
  447. performing QWK or REP file functions.  In this way, you have a nice
  448. little utility that does its thing with QWK's or REP's and then gets
  449. the heck out of the way when finished, enabling you to get on with
  450. your online business.  The status of "Express" will remain the same the
  451. next time the program is run, i.e. once selected, it is always selected,
  452. until the status is changed to "off", when it will remain unselected.  If
  453. you want to return to the main menu after performing a QWK or REP
  454. function, remember to uncheck the "Express" feature if it is checked (if
  455. there is an "X" inside the checkbox).
  456.  
  457. Corollary to the above, if you have "Delete warning" disabled, you
  458. will be able to exit even more quickly if you are performing any kind
  459. of file deletion.  This is meant to enhance the flow of ProQWK.
  460.  
  461. Command Line
  462. ------------
  463.  
  464. As a "command-line" utility, you may run ProQWK by launching it from another
  465. PCP/W 2 WAX file, if you use a script that sets the predefined WASP variable, S0 to
  466. the string value "allqwk" (case insensitive), and then launches PQ21.WAX.
  467. "Allqwk.wax" does just this, and is included in the archive, as is the source
  468. code, "Allqwk.was" (PLEASE SEE COMMENTS INCLUDED IN THE SOURCE "WAS" FILE).
  469.  
  470. When ProQWK 2.0 is invoked in this manner,it will automatically run through the
  471. renaming routine for ALL BBSes named in the ProQWK.INI file that are properly
  472. configured, without the need for any intervention from the user (NOTE:
  473. Unregistered users will have to click a button on a "nag screen" that appears
  474. after ProQWK runs -- so if you have not registered, don't use ProQWK in this way,
  475. unless you can afford to have it keep running until such a time as you can make
  476. the final click.).  You should not need to alter the source code at all in order
  477. to use this script, but it has been provided for those who want to incorporate
  478. it into larger scripts (such as late-night mail runs).
  479.  
  480. It is suggested that you run ProQWK normally and make sure things are set up the
  481. way you want them before using the "command line" option.
  482.  
  483. Further Info:
  484. -------------
  485.  
  486. For further information on "QWK" mail packets, and "REP" files, please
  487. consult your offline mail reader documentation.
  488.  
  489. If you have any comments, questions, or concerns about the ProQWK Utilities,
  490. please contact
  491.  
  492.         Carl Mellesmoen
  493.  
  494. via the Fidonet Windows echo, or send "snail" mail to:
  495.  
  496.         Carl Mellesmoen
  497.         238 - 4th St. East
  498.         Saskatoon, SK
  499.         S7H 1J1        Canada
  500.  
  501. OR, if you so choose, you may report any bugs/problems/questions/comments
  502. to Carl Mellesmoen on Ming Men BBS, Saskatoon, SK. ((306)-374-5544), in the
  503. "general" or "Windows" message areas.
  504.  
  505. Registering ProQWK
  506. ------------------
  507.  
  508. Send $10 to the "snail mail" address above, along with your name and address, 
  509. so that a registration code can be sent to you (don't forget to indicate that 
  510. you wish to register ProQWK, as I have other projects as well).  The registration 
  511. code is not to be shared with anyone (see licensing agreement below).
  512.  
  513. Licensing Agreement:
  514. --------------------
  515.  
  516. ProQWK 2 is supplied on an "as is" basis and the author is not
  517. liable for any problems encountered while using it, either by direct
  518. or indirect cause.  Users of this software, registered or not,
  519. assume all risk associated with its use.  Anyone may use this
  520. software for free without registering it for 30 days, and 30 days
  521. only.  After this period, they must either send the $10 registration
  522. fee to the author, along with their name and mailing address, or discontinue
  523. their use of the ProQWK 2.0 software.  Registration entitles the user to use the
  524. ProQWK 2.0 software on one or more computers (one at a time),
  525. or for multiple users to use the software on a single workstation.
  526. Any additional use requires additional registration(s).  The ProQWK
  527. software may be freely distributed in its original, archived form, and may not
  528. be in any way altered or reverse-engineered.  No user may divulge their user
  529. registration code to others, nor may they distribute it with copies of the
  530. software.  If any user is to post portions their "ProQWK.INI" file, in public message
  531. areas, they are forewarned to remove their registration code from such postings, as
  532. they are not permitted to do so, and they risk others using their registration code.
  533.  
  534. The licencing agreement is to be governed by the laws of the
  535. province of Saskatchewan, Canada.
  536.  
  537.  
  538.  
  539.  
  540. *** REVISION HISTORY ***
  541. ------------------------
  542. 11/09/94
  543.     VERSION 2.1
  544.     
  545.     - can now keep up to 35 extra QW? packets, rather than previous limit
  546.     of 10
  547.     - Multiple-selection list boxes used for QWK, QWK Delete, and BBS List 
  548.     (setup) dialog boxes.
  549.     - Setup for BBS's now easier to use - may add, edit or remove a BBS from
  550.     list much more easily than with previous versions.
  551.  
  552. 15/08/94
  553.     VERSION 2.0
  554.  
  555.     - PCPW/2-compatible version released
  556.     - ability to run in a "command-line" manner
  557.     - multiple file-deletion from the "point-and-click" QWK deletion dialog box
  558.     - some enhancements of source code (taking advantage of new WASP features)
  559.  
  560. 01/08/94
  561.     VERSION 1.3
  562.     - (version 1.3 - VB application to bridge gap between ProQWK 1.xx and 2.0)
  563.     - this version only - does not require a particular version of PCP/W in order
  564.     to run (can be used by anyone who has Windows 3.1 and VBRUN300.DLL)
  565.  
  566.  
  567. 20/01/94
  568.     VERSION 1.2
  569.     - corrected bug in which setup did not change options
  570. 09/01/94
  571.     VERSION 1.1
  572.     - corrected problem with auto-selection of default upload
  573.     protocol
  574.     - added "Cancel" button to setup routine - enables user to not
  575.     save changes
  576.     - changed default pushbuttons so that double-clicking will
  577.     process a selection automatically
  578.     - also allowed for bypassing file deletion warning via setup,
  579.     enabling smoother operation of ProQWK, especially when uploading
  580.     files
  581.     - changed exit message to a usermsg instead of a statmsg, since
  582.     proqwk changed to allow deletions without prompting
  583.     - corrected problem with "express" option and QWK delete (single
  584.     file) procedure - program will now exit quickly if express is
  585.     enabled, and will update INI file properly
  586.  
  587. 04/10/93
  588.     - VERSION 1.0
  589.     - changed upload protocol combobox to follow PC+/Win conventions
  590.     (i.e., not sorted, on right-hand side of dialog rather than left)
  591.     - fixed problems with "Express" option not updating correctly
  592.     - added "Express" option to QWK delete
  593.     - changed usermsg's to errormsg's where appropriate
  594.     - fixed bug: formerly, when a file was not selected in "QWK delete"
  595.     mode, did not check to make sure there is a file selected.  Now
  596.     user is told that he has to have a file selected before one
  597.     can be deleted
  598. 24/09/93
  599.     - REP option now defaults to last action
  600.     - icon added to show default REP action
  601. 01/09/93
  602.     - added selective QWK deleting - only one file at a time
  603.     - added groupboxes to setup dialog
  604. 31/08/93
  605.     - changed setup routine - protocol selection no longer a part of
  606.     setup
  607.     - protocol selection now takes place under "REP" management
  608.     module.  Default protocol (for each BBS according to the dialing
  609.     directory)is used, but user may change when
  610.     selecting file for download, as with PC+/Win regular d/l's.
  611.     - Fixed bug for restarting the protocol selection process when
  612.     a file transfer fails
  613.     - prettied up the setup dialog - centered BBS names - before
  614.     they were left-aligned
  615.     - users can now get rid of the "protocol" section entirely from
  616.     "proqwk.ini"
  617.     - removed forced delay between uploading & deleting rep files
  618.